W03-2. 포트 · 볼륨 · 네트워크 - 실습 가이드
3주차 실습: 포트 · 볼륨 · 네트워크
127.0.0.1바인딩으로 누가 접속할 수 있는지 직접 확인한다.- 노트북 폴더를 nginx 에 연결해서 파일을 고치면 바로 반영되는 것을 본다.
- 볼륨으로 PostgreSQL 데이터를 컨테이너 삭제 후에도 살려 둔다.
- 사용자 정의 네트워크에서 컨테이너끼리 이름으로 통신한다.
- Docker Desktop 실행 중 (Engine running)
- 터미널: macOS → 터미널 / Windows → PowerShell
- VS Code 설치 (사전 준비 4-2)
- 오늘부터 폴더 경로가 들어가서 macOS 와 Windows 명령이 다른 곳이 있습니다. 표시를 잘 보세요.
| 실습 | 내용 | 시간 |
|---|---|---|
| 0 | 작업 폴더 준비 | 4분 |
| 1 | 포트: 누가 접속할 수 있나 | 6분 |
| 2 | 바인드 마운트: 내 폴더를 웹 서버에 | 8분 |
| 3 | 볼륨 기본 | 5분 |
| 4 | 볼륨으로 DB 데이터 지키기 | 9분 |
| 5 | 네트워크: 이름으로 찾아가기 | 8분 |
| 6 | 정리 | 5분 |
실습 0. 작업 폴더 준비
이번 주부터 이 스터디의 파일은 모두 docker-study 폴더에 모읍니다.
macOS:
mkdir -p ~/docker-study/site
cd ~/docker-study
pwd
출력 예시: /Users/내이름/docker-study
Windows (PowerShell):
New-Item -ItemType Directory -Force "$HOME\docker-study\site"
cd "$HOME\docker-study"
pwd
출력 예시: C:\Users\내이름\docker-study
이제 VS Code 를 열고 File(파일) → Open Folder(폴더 열기) 로 docker-study 폴더를 엽니다.
VS Code 왼쪽 탐색기에서 site 폴더에 index.html 파일을 새로 만들고 아래 내용을 붙여 넣은 뒤 저장(Ctrl+S / Cmd+S) 합니다.
<!doctype html>
<html lang="ko">
<head><meta charset="utf-8"><title>3주차 실습</title></head>
<body>
<h1>내 노트북 폴더에서 온 페이지입니다</h1>
</body>
</html>
- Windows PowerShell 의
Out-File,echo ... >로 만들면 파일 맨 앞에 보이지 않는 글자(BOM)가 붙습니다. 실제로 확인해 보니 화면에가 찍힙니다. <meta charset="utf-8">이 없으면 한글이 깨집니다.
docker-study 폴더에서 실행합니다
터미널을 새로 열었다면 cd ~/docker-study (macOS) 또는 cd "$HOME\docker-study" (Windows) 부터 하세요.
실습 1. 포트: 누가 접속할 수 있나
컨테이너 두 개를 서로 다른 방식으로 띄웁니다.
docker run -d --name study-all -p 8082:80 nginx:1.30-alpine
docker run -d --name study-local -p 127.0.0.1:8081:80 nginx:1.30-alpine
docker port study-all
docker port study-local
출력 예시:
80/tcp -> 0.0.0.0:8082
80/tcp -> [::]:8082
80/tcp -> 127.0.0.1:8081
| 컨테이너 | 열린 주소 | 뜻 |
|---|---|---|
| study-all | 0.0.0.0:8082 |
노트북의 모든 네트워크 주소에서 받음 |
| study-local | 127.0.0.1:8081 |
노트북 자기 자신(localhost)에서만 받음 |
1-1. 내 노트북의 IP 주소 확인
macOS:
ipconfig getifaddr en0
Windows (PowerShell):
ipconfig | Select-String "IPv4"
출력 예시: 192.168.0.11 같은 주소가 나옵니다. 여러 줄이면 Wi-Fi 쪽 주소를 씁니다.
macOS 에서 아무것도 안 나오면 유선 랜일 수 있습니다.
ipconfig getifaddr en1을 해 보세요.
1-2. 브라우저로 비교
아래 4개 주소를 브라우저로 열어 봅니다. 192.168.0.11 자리에는 1-1 에서 확인한 내 IP 를 넣습니다.
| 주소 | 결과 |
|---|---|
| http://localhost:8082 | ✅ 보임 |
| http://192.168.0.11:8082 | ✅ 보임 → 옆 사람도 이 주소로 내 서버에 접속할 수 있다는 뜻 |
| http://localhost:8081 | ✅ 보임 |
| http://192.168.0.11:8081 | ❌ 연결 안 됨 → 바깥에서는 막혀 있음 |
옆 사람에게 내 IP 를 알려 주고 http://내IP:8082 에 접속해 보라고 하세요.
회사 Wi-Fi 나 PC 방화벽 설정에 따라 막힐 수도 있습니다. 막히면 위 표처럼 내 IP 로 내가 접속하는 것으로 확인해도 충분합니다.
1-3. 빈 포트 자동 배정 -P
docker run -d --name study-random -P nginx:1.30-alpine
docker port study-random
출력 예시: 번호는 그때그때 다릅니다.
80/tcp -> 0.0.0.0:32768
정리합니다.
docker rm -f study-all study-local study-random
실습 2. 바인드 마운트: 내 폴더를 웹 서버에
site 폴더를 nginx 의 웹 문서 폴더(/usr/share/nginx/html)에 읽기 전용으로 연결합니다.
macOS:
docker run -d --name study-site -p 8080:80 -v "$(pwd)/site:/usr/share/nginx/html:ro" nginx:1.30-alpine
Windows (PowerShell):
docker run -d --name study-site -p 8080:80 -v "${PWD}/site:/usr/share/nginx/html:ro" nginx:1.30-alpine
$(pwd) / ${PWD} 는 "지금 있는 폴더" 입니다
-v 에는 전체 경로를 줘야 합니다. 직접 타이핑하는 대신 현재 폴더 경로를 자동으로 넣어 주는 것입니다.
경로에 공백이나 한글이 있을 수 있으니 따옴표로 감싸는 것을 잊지 마세요. 한글 경로에서도 정상 동작하는 것을 확인했습니다.
2-1. 확인
http://localhost:8080 → "내 노트북 폴더에서 온 페이지입니다" 가 보이면 성공입니다.
2-2. 파일을 고치면 바로 반영된다
VS Code 에서 site/index.html 의 <h1> 내용을 아무렇게나 바꾸고 저장한 뒤, 브라우저를 새로고침합니다.
→ 컨테이너를 다시 만들지 않았는데 바뀐 내용이 바로 보입니다. 컨테이너가 내 폴더를 직접 보고 있기 때문입니다.
코드를 고칠 때마다 이미지를 새로 만들 필요 없이, 내 폴더를 연결해 두고 바로바로 확인합니다.
VS Code 에서 site 폴더에 about.html 파일을 하나 더 만들어 아무 내용이나 넣고 저장한 뒤 http://localhost:8080/about.html 도 열어 보세요.
2-3. 읽기 전용(:ro) 확인
컨테이너 안에서 파일을 만들어 봅니다.
docker exec study-site sh -c "echo hack > /usr/share/nginx/html/hack.html"
출력 예시:
sh: can't create /usr/share/nginx/html/hack.html: Read-only file system
컨테이너는 이 폴더를 읽기만 할 수 있습니다. 웹 서버가 공격당해도 원본 파일을 바꿀 수 없게 막는 안전장치입니다.
2-4. 연결 정보 확인
docker inspect --format "{{range .Mounts}}{{.Type}} | {{.Source}} -> {{.Destination}} | 쓰기가능={{.RW}}{{end}}" study-site
출력 예시 (Windows):
bind | C:\Users\내이름\docker-study/site -> /usr/share/nginx/html | 쓰기가능=false
docker rm -f study-site
컨테이너를 지워도
site폴더와 파일은 내 노트북에 그대로 있습니다. VS Code 에서 확인해 보세요.
실습 3. 볼륨 기본
3-1. 볼륨 만들기
docker volume create study-data
docker volume ls --filter name=study-
출력 예시:
study-data
DRIVER VOLUME NAME
local study-data
3-2. 컨테이너 A 가 쓰고, 컨테이너 B 가 읽기
docker run --rm -v study-data:/data alpine:3.24 sh -c "date > /data/note.txt"
docker run --rm -v study-data:/data alpine:3.24 cat /data/note.txt
출력 예시:
Thu Oct 1 05:03:01 UTC 2026
--rm 이라 실행이 끝나자마자 지워졌습니다.그런데도 두 번째 컨테이너가 첫 번째 컨테이너가 쓴 내용을 읽었습니다. 데이터가 컨테이너가 아니라 볼륨에 있기 때문입니다.
3-3. 볼륨은 어디에 있나
docker volume inspect study-data --format "{{.Driver}} | {{.Mountpoint}}"
출력 예시:
local | /var/lib/docker/volumes/study-data/_data
이 경로는 노트북이 아니라 Docker Desktop 의 리눅스 VM 안 경로입니다. 그래서 Finder 나 탐색기로는 보이지 않습니다. 볼륨은 Docker 를 통해서 다루는 것이 원칙입니다.
Docker Desktop 대시보드의 Volumes 화면에서는 내용을 볼 수 있습니다.
실습 4. 볼륨으로 DB 데이터 지키기
4-1. PostgreSQL 실행 (볼륨 연결)
docker run -d --name study-db -e POSTGRES_PASSWORD=studypw -v study-pgdata:/var/lib/postgresql postgres:18-alpine
| 옵션 | 의미 |
|---|---|
-e POSTGRES_PASSWORD=studypw |
환경 변수로 관리자 비밀번호를 넘김 (이 이미지는 이 값이 없으면 실행을 거부합니다) |
-v study-pgdata:/var/lib/postgresql |
study-pgdata 볼륨을 DB 데이터 폴더에 연결 (없으면 자동으로 생성) |
study-pgdata 볼륨은 만든 적이 없는데요?
-v 이름:경로 에서 그 이름의 볼륨이 없으면 Docker 가 알아서 만듭니다.
4-2. DB 가 준비될 때까지 기다리기
PostgreSQL 은 처음 실행할 때 초기화하느라 몇 초 걸립니다. 로그를 확인합니다.
docker logs --tail 2 study-db
출력 예시: 마지막 줄에 아래 문장이 보이면 준비 완료입니다.
... LOG: database system was shut down at 2026-10-01 05:05:15 UTC
... LOG: database system is ready to accept connections
psql: error: connection to server on socket "/var/run/postgresql/.s.PGSQL.5432" failed: No such file or directory
고장이 아니라 아직 준비 중이라는 뜻입니다. 5~10초 기다렸다가 다시 하세요.
4-3. 테이블을 만들고 데이터 넣기
docker exec study-db psql -U postgres -c "CREATE TABLE memo (id serial PRIMARY KEY, body text);"
docker exec study-db psql -U postgres -c "INSERT INTO memo (body) VALUES ('첫 번째 메모'), ('두 번째 메모');"
docker exec study-db psql -U postgres -c "SELECT * FROM memo;"
출력 예시:
CREATE TABLE
INSERT 0 2
id | body
----+--------------
1 | 첫 번째 메모
2 | 두 번째 메모
(2 rows)
psql은 PostgreSQL 에 접속하는 명령 도구입니다. 이미지 안에 들어 있어서 노트북에 따로 설치할 필요가 없습니다.
4-4. DB 컨테이너를 지우고 다시 만들기
docker rm -f study-db
docker run -d --name study-db -e POSTGRES_PASSWORD=studypw -v study-pgdata:/var/lib/postgresql postgres:18-alpine
몇 초 기다린 뒤(4-2 처럼 로그 확인):
docker exec study-db psql -U postgres -c "SELECT * FROM memo;"
출력 예시:
id | body
----+--------------
1 | 첫 번째 메모
2 | 두 번째 메모
(2 rows)
컨테이너는 새것이지만 같은 볼륨을 연결했기 때문에 데이터가 그대로 있습니다.
"컨테이너는 언제든 버리고 새로 만들 수 있고, 데이터는 볼륨에 둔다" 가 컨테이너 운영의 기본 원칙입니다.
-v 없이 DB 를 띄웠다면 어떻게 됐을까요? → 4-4 에서 컨테이너를 지우는 순간 메모가 모두 사라졌을 것입니다.
실습 5. 네트워크: 이름으로 찾아가기
5-1. 기본 네트워크에서는 이름을 못 찾는다
docker run -d --name study-web nginx:1.30-alpine
docker run --rm alpine:3.24 wget -qO- -T 3 http://study-web
출력 예시:
wget: bad address 'study-web'
wget은 웹 페이지를 받아 오는 명령입니다.bad address는 "study-web이라는 이름의 주소를 모르겠다" 는 뜻입니다.
IP 로는 될까요?
docker inspect --format "{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}" study-web
출력 예시: 172.17.0.2
docker run --rm alpine:3.24 wget -qO- -T 3 http://172.17.0.2
172.17.0.2자리에 위에서 나온 IP 를 넣으세요. nginx 페이지 HTML 이 출력됩니다.
IP 로는 되지만, 컨테이너를 다시 만들면 IP 가 바뀔 수 있어서 실무에서는 쓸 수 없습니다.
docker rm -f study-web
5-2. 사용자 정의 네트워크 만들기
docker network create study-net
docker network ls --filter name=study-
출력 예시:
8bf5df9a61d3ec6d...
NETWORK ID NAME DRIVER SCOPE
8bf5df9a61d3 study-net bridge local
5-3. 같은 네트워크에서는 이름으로 접속
docker run -d --name study-web --network study-net nginx:1.30-alpine
docker run --rm --network study-net alpine:3.24 wget -qO- http://study-web
출력 예시: nginx 페이지 HTML 이 나옵니다.
<!DOCTYPE html>
<html>
<head>
<title>Welcome to nginx!</title>
...
이름이 어떤 IP 로 바뀌는지도 볼 수 있습니다.
docker run --rm --network study-net alpine:3.24 nslookup study-web
출력 예시 (끝부분):
Name: study-web
Address: 172.24.0.2
Docker 의 내장 DNS 가
study-web→172.24.0.2로 바꿔 줍니다. 컨테이너를 다시 만들어 IP 가 바뀌어도 이름은 그대로 쓸 수 있습니다.
5-4. 웹 + DB 를 같은 네트워크로 (DB 포트는 공개하지 않음)
실습 4의 DB 를 지우고, 이번에는 study-net 에 연결해서 다시 띄웁니다. 같은 볼륨을 씁니다.
docker rm -f study-db
docker run -d --name study-db --network study-net -e POSTGRES_PASSWORD=studypw -v study-pgdata:/var/lib/postgresql postgres:18-alpine
몇 초 기다린 뒤, 다른 컨테이너에서 이름(study-db)으로 DB 에 접속합니다.
docker run --rm --network study-net -e PGPASSWORD=studypw postgres:18-alpine psql -h study-db -U postgres -c "SELECT * FROM memo;"
출력 예시:
id | body
----+--------------
1 | 첫 번째 메모
2 | 두 번째 메모
(2 rows)
| 확인할 점 | 의미 |
|---|---|
-h study-db |
IP 가 아니라 컨테이너 이름으로 DB 서버를 찾았습니다 |
DB 에 -p 를 주지 않았음 |
노트북 바깥에서는 DB 에 접근할 수 없습니다. 같은 네트워크의 컨테이너만 접속 가능합니다 |
| 데이터가 그대로 | 실습 4의 볼륨을 다시 연결했기 때문입니다 |
지금 한 일(네트워크 만들기 → DB 띄우기 → 볼륨 연결 → 앱 띄우기)을 파일 하나에 적어 두고 명령 한 줄로 하는 것이 Docker Compose 입니다.
5-5. 다른 네트워크에서는 안 보인다
docker run --rm alpine:3.24 wget -qO- -T 3 http://study-web
출력 예시:
wget: bad address 'study-web'
--network를 주지 않은 컨테이너(기본 네트워크)에서는study-net안의 컨테이너가 보이지 않습니다. 네트워크가 곧 격리의 경계입니다.
실습 6. 정리
6-1. 쓰는 중인 것은 지울 수 없다
docker volume rm study-pgdata
docker network rm study-net
출력 예시:
Error response from daemon: remove study-pgdata: volume is in use - [e4387d7720a3...]
Error response from daemon: error while removing network: network study-net has active endpoints (name:"study-web" id:"4ce42ada71a3", name:"study-db" id:"e2e5c3d61f37")
볼륨과 네트워크도 이미지처럼, 쓰는 컨테이너가 있으면 지울 수 없습니다.
6-2. 순서대로 정리
컨테이너 → 네트워크 → 볼륨 순서로 지웁니다.
docker rm -f study-web study-db
docker network rm study-net
docker volume rm study-data study-pgdata
확인합니다.
docker ps -a --filter name=study-
docker volume ls --filter name=study-
docker network ls --filter name=study-
세 목록이 모두 비어 있으면 정리 끝입니다. ✅
컨테이너와 달리 볼륨 삭제는 되돌릴 수 없습니다. 실무에서는 docker volume rm 전에 꼭 한 번 더 확인하세요.
docker-study/site 폴더(바인드 마운트)는 다음 주에도 쓰지 않으니 남겨 둬도, 지워도 됩니다.
자주 나는 문제와 해결
| 증상 | 원인 | 해결 |
|---|---|---|
페이지에  가 보이거나 한글이 깨짐 |
PowerShell 로 파일을 만들었거나 <meta charset="utf-8"> 이 없음 |
VS Code 로 파일을 다시 만들고 meta 태그 확인 |
-v 로 연결했는데 nginx 가 403 Forbidden |
연결한 폴더에 index.html 이 없음 (경로가 틀렸을 가능성) |
docker inspect 로 Source 경로 확인, 폴더 안에 파일이 있는지 확인 |
| 바인드 마운트 폴더가 비어 보임 | docker-study 폴더가 아닌 곳에서 명령 실행 |
pwd 로 현재 위치 확인 후 cd |
psql: error: connection to server on socket ... failed |
DB 가 아직 초기화 중 | 5~10초 뒤 다시 시도 (docker logs --tail 2 study-db 로 확인) |
FATAL: password authentication failed for user "postgres" |
같은 볼륨을 다른 비밀번호로 다시 씀 | 비밀번호는 볼륨을 처음 만들 때만 적용됩니다. 실습용이면 볼륨을 지우고 다시 시작 |
wget: bad address |
두 컨테이너가 같은 사용자 정의 네트워크에 없음 | 둘 다 --network study-net 으로 실행했는지 확인 |
volume is in use / has active endpoints |
쓰는 컨테이너가 남아 있음 | 컨테이너부터 지우기 |
오늘 쓴 명령어 정리
| 분류 | 명령어 | 하는 일 |
|---|---|---|
| 포트 | -p 8080:80 / -p 127.0.0.1:8080:80 / -P |
전체 공개 / 내 노트북만 / 자동 배정 |
docker port <이름> |
포트 연결 확인 | |
| 바인드 마운트 | -v "$(pwd)/site:/경로:ro" (macOS)-v "${PWD}/site:/경로:ro" (Windows) |
현재 폴더 아래 site 를 연결 (읽기 전용) |
| 볼륨 | docker volume create / ls / inspect / rm |
볼륨 관리 |
-v 볼륨이름:/경로 |
볼륨 연결 (없으면 자동 생성) | |
| 환경 변수 | -e 이름=값 |
컨테이너에 설정 값 전달 |
| 네트워크 | docker network create / ls / rm |
네트워크 관리 |
--network 네트워크이름 |
그 네트워크에 연결해서 실행 |
복습 과제
확인 퀴즈
-p 8080:80과-p 127.0.0.1:8080:80의 차이는?- 바인드 마운트와 볼륨은 각각 어떤 데이터에 쓰는 것이 좋을까요?
- 실습 4-4에서 DB 컨테이너를 지웠는데 메모가 남아 있었던 이유는?
- PostgreSQL 18 이미지에 볼륨을 연결할 컨테이너 쪽 경로는?
- 기본 네트워크에서
wget http://study-web이 실패한 이유와 해결 방법은? - 실습 5-4에서 DB 에
-p를 주지 않은 이유는?
-p 8080:80은 노트북의 모든 네트워크 주소로 공개되어 다른 PC 도 접속할 수 있고,127.0.0.1을 붙이면 내 노트북에서만 접속할 수 있습니다.- 바인드 마운트는 내가 직접 보고 고치는 파일(소스 코드, 설정 파일)에, 볼륨은 앱이 쌓는 데이터(DB 데이터 등)에 씁니다.
- 데이터가 컨테이너가 아니라 볼륨(study-pgdata) 에 저장되어 있었고, 새 컨테이너에 같은 볼륨을 다시 연결했기 때문입니다.
/var/lib/postgresql(17 이하는/var/lib/postgresql/data)- 기본 bridge 네트워크에는 이름을 IP 로 바꿔 주는 DNS 가 없기 때문입니다.
docker network create로 사용자 정의 네트워크를 만들고 두 컨테이너를--network로 연결하면 이름으로 통신할 수 있습니다. - DB 는 같은 네트워크의 앱만 접속하면 되기 때문입니다. 포트를 공개하지 않으면 노트북 바깥에서 DB 에 접근할 길이 없어 더 안전합니다.
도전 과제 (선택)
study-net네트워크에 nginx 두 개(study-a,study-b)를 띄우고,study-a안에서wget -qO- http://study-b가 되는지 확인해 보세요. (docker exec study-a wget -qO- http://study-b)- 실행 중인 컨테이너를 나중에 네트워크에 붙일 수도 있습니다.
docker network connect study-net <컨테이너이름>을 찾아서 써 보세요. - 다 했으면 실습 6처럼 컨테이너 → 네트워크 → 볼륨 순서로 정리합니다.
지금까지는 남이 만든 이미지(nginx, postgres)만 썼습니다. 다음 주에는 스터디 예제 앱 방명록(guestbook) 을 내 이미지로 직접 만들고, Docker Hub 에 올려서 다른 사람이 받아 쓸 수 있게 합니다.
Docker Hub 아이디와 비밀번호를 꼭 기억해 오세요.
네비게이션
| 이전 | 목록 | 다음 |
|---|---|---|
| ◀ 3주차 강의 노트 | 목록으로 | 4주차 강의 노트 ▶ |